Summary

This PR closes the first governed execution loop in ModularityKit.Mutator.Governance and aligns the package docs with the current runtime shape.

Added

• governed execution contracts and runtime orchestration through IGovernanceExecutionManager and GovernanceExecutionManager
• request execution outcome handling, guarded execution persistence, and governance-aware mutation wrapping
• end-to-end governance execution coverage in ModularityKit.Mutator.Governance.Tests
• runnable Examples/Governance/GovernedExecution sample
• ADR-027 for the governed execution manager

Changed

• MutationRequest construction moved into MutationRequestFactory so the request model stays focused on state
• governance examples and tests now use the request factory entry points
• governance package README now describes the runtime by flow and responsibility instead of only folder layout
• governance example READMEs now point to the updated request factory usage

Result

Governance now owns the path from approved request to version resolution, core mutation execution, and terminal request state. The package documentation also reflects the current execution model instead of describing major runtime pieces as future work.

Testing

• dotnet build src/ModularityKit.Mutator.Governance.csproj -c Release
• dotnet build Examples/Governance/GovernedExecution/GovernedExecution.csproj -c Release
• dotnet test Tests/ModularityKit.Mutator.Governance.Tests/ModularityKit.Mutator.Governance.Tests.csproj -c Release

Linked Issues

• Closes [Task]: Implement governed execution manager #16

Checklist

• Governed execution resolves requests before execution
• Terminal execution outcomes are persisted through governance runtime
• Governance execution has runnable example coverage
• Governance execution has test coverage
• ADR and package docs reflect the new runtime shape